---
title: Trello
description: Gérer les tableaux et cartes Trello
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="trello"
  color="#0052CC"
/>

{/* MANUAL-CONTENT-START:intro */}
[Trello](https://trello.com) est un outil de collaboration visuel qui vous aide à organiser des projets, des tâches et des flux de travail à l'aide de tableaux, de listes et de cartes.

Avec Trello dans Sim, vous pouvez :

- **Lister les tableaux et les listes** : Visualiser les tableaux auxquels vous avez accès et leurs listes associées.
- **Lister et rechercher des cartes** : Récupérer toutes les cartes d'un tableau ou filtrer par liste pour voir leur contenu et leur statut.
- **Créer des cartes** : Ajouter de nouvelles cartes à une liste Trello, y compris des descriptions, des étiquettes et des dates d'échéance.
- **Mettre à jour et déplacer des cartes** : Modifier les propriétés des cartes, déplacer des cartes entre les listes, et définir des dates d'échéance ou des étiquettes.
- **Obtenir l'activité récente** : Récupérer les actions et l'historique d'activité pour les tableaux et les cartes.
- **Commenter les cartes** : Ajouter des commentaires aux cartes pour la collaboration et le suivi.

L'intégration de Trello avec Sim permet à vos agents de gérer les tâches, les tableaux et les projets de votre équipe de manière programmatique. Automatisez les flux de travail de gestion de projet, maintenez les listes de tâches à jour, synchronisez avec d'autres outils, ou déclenchez des flux de travail intelligents en réponse aux événements Trello — le tout grâce à vos agents IA.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez avec Trello pour gérer les tableaux et les cartes. Listez les tableaux, listez les cartes, créez des cartes, mettez à jour des cartes, obtenez des actions et ajoutez des commentaires.

## Outils

### `trello_list_lists`

Lister toutes les listes d'un tableau Trello

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `boardId` | chaîne | Oui | ID du tableau dont on veut lister les listes |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Si l'opération a réussi |
| `lists` | array | Tableau d'objets liste avec id, nom, fermé, position et idTableau |
| `count` | number | Nombre de listes retournées |
| `error` | string | Message d'erreur si l'opération a échoué |

### `trello_list_cards`

Lister toutes les cartes d'un tableau Trello

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | Oui | ID du tableau dont on veut lister les cartes |
| `listId` | string | Non | Optionnel : Filtrer les cartes par ID de liste |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Si l'opération a réussi |
| `cards` | array | Tableau d'objets carte avec id, nom, description, url, IDs du tableau/liste, étiquettes et date d'échéance |
| `count` | number | Nombre de cartes retournées |
| `error` | string | Message d'erreur si l'opération a échoué |

### `trello_create_card`

Créer une nouvelle carte sur un tableau Trello

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | Oui | ID du tableau sur lequel créer la carte |
| `listId` | string | Oui | ID de la liste dans laquelle créer la carte |
| `name` | string | Oui | Nom/titre de la carte |
| `desc` | string | Non | Description de la carte |
| `pos` | string | Non | Position de la carte \(top, bottom, ou nombre flottant positif\) |
| `due` | string | Non | Date d'échéance \(format ISO 8601\) |
| `labels` | string | Non | Liste d'IDs d'étiquettes séparés par des virgules |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Indique si la carte a été créée avec succès |
| `card` | objet | L'objet carte créé avec id, nom, description, url et autres propriétés |
| `error` | chaîne | Message d'erreur si l'opération a échoué |

### `trello_update_card`

Mettre à jour une carte existante sur Trello

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `cardId` | chaîne | Oui | ID de la carte à mettre à jour |
| `name` | chaîne | Non | Nouveau nom/titre de la carte |
| `desc` | chaîne | Non | Nouvelle description de la carte |
| `closed` | booléen | Non | Archiver/fermer la carte \(true\) ou la rouvrir \(false\) |
| `idList` | chaîne | Non | Déplacer la carte vers une liste différente |
| `due` | chaîne | Non | Date d'échéance \(format ISO 8601\) |
| `dueComplete` | booléen | Non | Marquer la date d'échéance comme terminée |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | booléen | Indique si la carte a été mise à jour avec succès |
| `card` | objet | L'objet carte mis à jour avec id, nom, description, url et autres propriétés |
| `error` | chaîne | Message d'erreur si l'opération a échoué |

### `trello_get_actions`

Obtenir l'activité/les actions d'un tableau ou d'une carte

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `boardId` | chaîne | Non | ID du tableau dont on veut obtenir les actions \(soit boardId soit cardId requis\) |
| `cardId` | chaîne | Non | ID de la carte dont on veut obtenir les actions \(soit boardId soit cardId requis\) |
| `filter` | chaîne | Non | Filtrer les actions par type \(ex. : "commentCard,updateCard,createCard" ou "all"\) |
| `limit` | nombre | Non | Nombre maximum d'actions à retourner \(par défaut : 50, max : 1000\) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Indique si l'opération a réussi |
| `actions` | array | Tableau d'objets d'action avec type, date, membre et données |
| `count` | number | Nombre d'actions retournées |
| `error` | string | Message d'erreur si l'opération a échoué |

### `trello_add_comment`

Ajouter un commentaire à une carte Trello

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `cardId` | string | Oui | ID de la carte à commenter |
| `text` | string | Oui | Texte du commentaire |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Indique si le commentaire a été ajouté avec succès |
| `comment` | object | L'objet commentaire créé avec id, texte, date et membre créateur |
| `error` | string | Message d'erreur si l'opération a échoué |

## Notes

- Catégorie : `tools`
- Type : `trello`
